home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 5 / The 640 Meg Shareware Studio CD-ROM Volume V (Data Express)(1994).ISO / amiga / ssaccess.lha / SSAccess.doc < prev   
Text File  |  1994-04-12  |  3KB  |  86 lines
  1. SSAccess for Serial Server 2.25 by The Mad Scientist
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Serial Server is copyright (c) by Mike Mossman. Special thanks to Mike
  5. for writing Serial Server in the first place, and for adding all the
  6. stuff I asked for. Great program Mike!
  7.  
  8. SSAccess is the first 3rd party utility for use with the new Serial
  9. Server V2.25 (or greater). Now that Serial Server supports more levels
  10. and interactive commands, it is possible to write useful external
  11. commands for it (you could even go as far as to write a complete command
  12. driven BBS system that uses the Serial Server remote shell). So, dust
  13. off your C compilers out there!
  14.  
  15. With older versions of Serial Server, there were only 2 levels of access
  16. (plus the sysop). It was easy to make a simple help file to show users
  17. what commands and devices they had access to.
  18.  
  19. But since Serial Server 2.25 has 25 levels of access (plus the sysop),
  20. the help file could become a real nightmare.
  21.  
  22. That is where SSAccess comes in. It will give the user a list of what
  23. commands and devices they may use, and tell them whether command line
  24. options are allowed, and whether the command will run in interactive
  25. mode or not (see your Serial Server 2.25 docs). You can simplify your help
  26. file to simply tell them any important commands (like access) they should
  27. know about and how to get help on other commands (I use aliases like
  28. MAN and TOPICS, see below).
  29.  
  30. You may use SSAccess two ways:
  31.  
  32. Online 
  33. ~~~~~~
  34. To set this up, do the following:
  35.  
  36.  [1] Copy SSAccess to SSBBS:
  37.  
  38.  [2] Add the line ALIAS ACCESS SSBBS:SSACCESS to your script file that
  39.      Serial Server runs when started.
  40.  
  41.      You can do a lot of neat things with aliases in the startup script,
  42.      I use:
  43.  
  44.         ALIAS MAN TYPE SSBBS:MAN/[]
  45.  
  46.      to allow users to read help files on commands, and
  47.  
  48.         ALIAS TOPICS DIR SSBBS:MAN
  49.  
  50.      to give users a list of available topics. Of course, the user
  51.      must have access to the MAN and TOPICS commands, and you will
  52.      have to create the help files in SSBBS:MAN/
  53.  
  54.  [3] Add ACCESS as a command to your config, with all users allowed
  55.      access to it (level a). Do not allows command line options or
  56.      interactivity (set these to level z).
  57.  
  58.  [4] Put a line something like:
  59.  
  60.        Type ACCESS for a list of commands you may use
  61.  
  62.      in your help file.
  63.  
  64. You are done. It is online. Serial Server 2.25 writes environment variables
  65. with the user's name and level, and this is what SSAccess reads to get
  66. the info about the user. So, YOU MUST HAVE ENV: ASSIGNED to use SSAccess
  67. (you should have it assigned anyway, of course).
  68.  
  69. Offline
  70. ~~~~~~~
  71. If you want to quickly check what levels have access to what commands from
  72. the CLI without using the Sysop module, at any CLI type:
  73.  
  74. SSBBS:SSACCESS <level>
  75.  
  76. where level is between a and z (note: levels are always lower case).
  77.  
  78. Also, if a user is online in Serial Server, just type
  79.  
  80. SSBBS:SSACCESS
  81.  
  82. to see who they are and what they can do.
  83.  
  84. That's all folks!
  85.  
  86.